home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr26 / minder23.zip / README23 < prev    next >
Text File  |  1993-06-07  |  13KB  |  200 lines
  1.  
  2.                FASTMINDER INTERFACE 2.3 INSTALLATION INSTRUCTIONS
  3.                FOR USE WITH IBM AND IBM-COMPATIBLE COMPUTERS ONLY
  4.                ──────────────────────────────────────────────────
  5.                Absolutely essential:  80286-based computer system
  6.                Strongly recommended:  12MHz or higher clock speed
  7.                ──────────────────────────────────────────────────
  8.                WARNING: FOR BEST RESULTS DO NOT USE WITH ANSI.SYS
  9.                INTERFACE MAY NOT WORK PROPERLY WITH SOME MONITORS
  10.  
  11.  
  12.   ───────────────────────────────────────────────────────────────────────────
  13.   INTRODUCTORY INFORMATION ──────────────────────────────────────────────────
  14.   ───────────────────────────────────────────────────────────────────────────
  15.  
  16.        This key-driven programmable interface does not come with an automatic
  17.   installation system since installation requires copying just two files from
  18.   the diskette to the hard drive. The user should put the MINDER.DAT datafile
  19.   in the MAIN DIRECTORY of the hard drive because that is where the interface
  20.   will be looking for it. The actual MINDER.EXE program may be located in any
  21.   directory on the hard drive. The default drive for writing the datafile and
  22.   for executing the stored command strings is now USER-SELECTABLE through the
  23.   INSERT key, though the program still begins and exits in the root directory.
  24.   Datafiles are read from the LAUNCH drive and written to whichever drive has
  25.   been specified as the default when the program terminates.
  26.  
  27.        After the interface files have been installed, the user should execute
  28.   the program and press THE PLUS KEY to invoke the help section. This section
  29.   should be looked at carefully since it explains the overall organization of
  30.   the interface and how the different features are accessed. For example, the
  31.   behavior of the semicolon (;) key has CHANGED, so please read the paragraph
  32.   about the key. The help section's warning about direct editing of datafiles
  33.   has vanished, but still applies. Users should not edit these files directly
  34.   because their unique formatting cannot be disturbed without destroying them
  35.   Users should remember that this program functions ONLY with these datafiles
  36.  
  37.   ───────────────────────────────────────────────────────────────────────────
  38.   VERSION 2.0 INFORMATION ───────────────────────────────────────────────────
  39.   ───────────────────────────────────────────────────────────────────────────
  40.  
  41.        Version 2.0 incorporates a REPLACEABLE PARAMETER, which should greatly
  42.   enhance the interface's utility for those individuals with several programs
  43.   that require the filename specification in the middle of the command string
  44.   rather than at the end. The parameter should even be useful for persons who
  45.   automate common tasks by creating single-line, single-parameter batch files
  46.   The inclusion of the replaceable parameter was made possible by Mr. William
  47.   Smith, whose informative article "An Essential String Function Library" was
  48.   published in the January 1993 issue of -The C Users Journal-
  49.  
  50.        Version 2.0 offers AUTOMATED KEY SORTING, which replaces the primitive
  51.   copy function provided in earlier releases. This automated sorting function
  52.   works with single page copying only, and operates like this: the source key
  53.   settings are copied to the target key and all other settings (including the
  54.   target key's original settings) are moved forward or backward to compensate
  55.   Automated sorting does not apply, however, when copying key settings across
  56.   pages; that function remains unchanged (the source key information destroys
  57.   the target key information without changing the settings of any other keys)
  58.  
  59.        Finally, Version 2.0 offers users the possibility of reading ALTERNATE
  60.   DATAFILES either from the command line or from within the program. Datafile
  61.   names start with 'minder' and are selected by entering the file's extension
  62.   Extensions may be entered from the command line (C:\> minder ann) or inside
  63.   the interface by pressing the apostrophe key, adjacent to the semicolon key
  64.   The apostrophe key initiates the datafile loading sequence, which begins by
  65.   asking if the currently loaded file should be stored or discarded. Then the
  66.   prompt for the new datafile will appear, UNLESS the original datafile could
  67.   not be stored properly. When this prompt for the new datafile appears, just
  68.   enter the extension of the datafile you want (remembering that the datafile
  69.   must reside in the ROOT directory). This should be useful for multiple user
  70.   environments, power users running hundreds of applications, and persons who
  71.   like to change program colors often. NOTICE: pressing ENTER at the datafile
  72.   selection prompt or executing the program without arguments defaults to the
  73.   'minder.dat' datafile. Press the space bar and ENTER at the datafile prompt
  74.   if you want to load the datafile 'minder' with no extension (this cannot be
  75.   done from the command line)
  76.  
  77.   ───────────────────────────────────────────────────────────────────────────
  78.   REPLACEABLE PARAMETERS ────────────────────────────────────────────────────
  79.   ───────────────────────────────────────────────────────────────────────────
  80.  
  81.        In versions 1.2 through 1.4 of the program, pressing any alphabetic or
  82.   numeric key would generate an information-window prompt, requesting command
  83.   arguments. The arguments would be tacked onto the end of the command string
  84.   stored inside the datafile. When automatic mode had been activated, however
  85.   the program would execute the specified option string automatically without
  86.   requesting arguments. VERSION 2.0 OPERATES DIFFERENTLY. This version allows
  87.   users to place a single replaceable parameter in each stored command string
  88.   The replaceable parameter (indicated by the percent sign WITHOUT any number 
  89.   following it) marks the position in the command string at which any command
  90.   arguments entered at the prompt will be inserted. Only one parameter may be
  91.   placed into any command string; if multiple parameters are found, the first
  92.   parameter will be used to determine the position at which command arguments
  93.   are inserted
  94.  
  95.         Because of this added feature, the interface now operates differently
  96.   whenever the alphanumeric keys are pressed. If the command string requested
  97.   by that keypress has a replaceable parameter, the information-window prompt
  98.   for the command arguments will appear. Conversely, if the command string is
  99.   lacking a replaceable parameter, the command will be EXECUTED AUTOMATICALLY
  100.   This method of operation (argument prompts for strings with parameters, and 
  101.   automatic execution for strings without parameters) also works for function
  102.   keys whenever automatic mode has been set. With auto mode set, the pressing
  103.   of directory keys will generate AN ARGUMENTS PROMPT if the automatic option
  104.   string contains a replaceable parameter. If the automatic option string has
  105.   no parameter, however, it will execute automatically. Users should remember
  106.   that ANY PERCENT SIGN in the command string will be seen as a parameter and
  107.   treated as such by the program. Users should also be careful when selecting
  108.   arguments for automatic option commands since these commands will change if
  109.   the operation page changes
  110.  
  111.   ───────────────────────────────────────────────────────────────────────────
  112.   VERSION 2.2 INFORMATION ───────────────────────────────────────────────────
  113.   ───────────────────────────────────────────────────────────────────────────
  114.   ALSO COVERS VERSION 2.1
  115.  
  116.        Version 2.2 makes it possible to replace multiple parameters in stored
  117.   command strings; the first five parameters may be replaced by user-supplied
  118.   arguments. Because parameters remain unnumbered, a command arguments prompt
  119.   is generated for EACH parameter (through the fifth) found within the stored
  120.   command string. For example, the stored operation key  cl %.c %.obj > %.err
  121.   would generate three separate argument prompts, although parameters one and  
  122.   three might represent the same (expanded) filename. Users wishing to expand
  123.   several parameters similarly should note that the F3 key functions the same
  124.   at string prompts as it does at the DOS command line; it recalls the string
  125.   entered immediately prior to the current prompt. Unfortunately, this cannot
  126.   be used to recall strings that were entered several prompts ago; users will
  127.   have to retype such strings manually. Finally, Version 2.2 offers users the
  128.   ability to blank their screens by pressing the back-slash key; this feature
  129.   might prove helpful to people who receive phone calls during computer hours
  130.  
  131.   ───────────────────────────────────────────────────────────────────────────
  132.   VERSION 2.3 INFORMATION ───────────────────────────────────────────────────
  133.   ───────────────────────────────────────────────────────────────────────────
  134.  
  135.        Version 2.3 allows users to select the default directory for operation
  136.   strings and for writing the datafile. Upon entering the program the default
  137.   directory will remain the LAUNCH directory (the directory will not be reset
  138.   to C) until the user changes it with the INSERT key. Pressing that key will
  139.   generate a prompt requesting a drive letter from A to Z (even if the user's
  140.   computer does not have that many drives). Press the letter that corresponds
  141.   to the drive you want to have as your default drive. Pressing the space bar
  142.   will report the current default directory for the current default drive, as
  143.   in previous versions. Version 2.3 also contains better handling of diskette
  144.   drive errors (like those encountered when the drive is accessed but nothing
  145.   has been placed inside it for reading). These error handling routines might
  146.   not function correctly under all circumstances; I was only able to test for
  147.   missing diskettes and not for other types of diskette errors. Please do not
  148.   hesitate to report problems with these routines; I will try to fix whatever
  149.   bugs are found to the best of my (meager) abilities.
  150.  
  151.   ───────────────────────────────────────────────────────────────────────────
  152.   REGISTRATION INFORMATION ──────────────────────────────────────────────────
  153.   ───────────────────────────────────────────────────────────────────────────
  154.  
  155.        FASTMINDER version 2.3 is public domain software; there are absolutely
  156.   no restrictions of any kind governing its duplication, distribution, or use
  157.   Users are nonetheless urged to report any errors they encounter while using
  158.   the software and are encouraged to share their opinions about the interface
  159.   design with the programmer. Postcards remain the preferred vehicle for user
  160.   feedback and should be mailed to the address found in the user help section
  161.   Also, please distribute the program with its documentation in original form
  162.  
  163.        Version 2.3 was developed and compiled with the following packages:
  164.  
  165.        COMPUTER:  FastMicro FastData ValueLine 486SX-25, Super VGA Color
  166.         EDITORS:  Video Display Editor 1.65, Programmer's Workbench 2.1
  167.  
  168.        COMPILER:  Microsoft (R) C/C++ Optimizing Compiler Version 7.00
  169.         options:  /Bm4096 /G2 /Ozaxb2 /W4 minder.c txtonly.obj
  170.  
  171.          LINKER:  Microsoft (R) Segmented Executable Linker Version 5.30
  172.         options:  /exepack /farcall /noe /noi /packc /packf graphics.lib
  173.  
  174.   Version 2.4 should incorporate Wilson Hitchings' INPUTIT data-input routine
  175.   Version 2.5 was slated to include memory swapping but this may be postponed
  176.  
  177.                          Douglas Mohn  (72124,2713)
  178.  
  179.   ───────────────────────────────────────────────────────────────────────────
  180.   LATE-BREAKING INFORMATION ─────────────────────────────────────────────────
  181.   ───────────────────────────────────────────────────────────────────────────
  182.  
  183.   Recent testing of the interface revealed the need for this final paragraph:
  184.  
  185.        When changing datafiles from within the program, users should be aware
  186.   that the current directory will change to the root directory, the directory
  187.   key window will become the active window (the one subject to scrolling) and
  188.   both the directory key and operation key windows will be reset to page zero.
  189.   In addition, the key-lock status and the key-lock password will reflect the
  190.   settings of the datafile being loaded. THE AUTOMATIC OPTION SETTING, THOUGH,
  191.   WILL NOT BE RESET but instead will remain constant across multiple datafile
  192.   loading sequences. This preservation of the automatic option setting, while
  193.   not intended, may nonetheless prove useful to persons who use the automatic
  194.   option capability frequently. This programming oversight is therefore being
  195.   retained in version 2.3A and might very well be retained in future releases
  196.  
  197.   ───────────────────────────────────────────────────────────────────────────
  198.   END OF FILE ───────────────────────────────────────────────────────────────
  199.   ───────────────────────────────────────────────────────────────────────────
  200.